←Select platform

RecognizePage(string,int,List<IMasterFormsCategory>) Method

Summary
Recognize the unknown page type.

Syntax
C#
C++/CLI
Java
Python
public AutoFormsRecognizePageResult recognizePage( 
   java.lang.String fileName, 
   int pageNumber, 
   java.util.List<IMasterFormsCategory> categories 
); 
public: 
AutoFormsRecognizePageResult^ RecognizePage(  
   String^ fileName, 
   int pageNumber, 
   List<IMasterFormsCategory^>^ categories 
)  
def RecognizePage(self,fileName,pageNumber,categories): 

Parameters

fileName
A System.String containing the name of the unknown form image file.

pageNumber
The unknown page number in the unknown form from  fileName.

categories
List of Master Forms categories to use in comparison, pass null or empty to use all Master Forms in the repository.

Return Value

The result of the recognition will have the result of the Master Form Page with maximum confidence. If the confidence is less than MinimumConfidenceKnownForm it will return null, i.e. the form type is unknown and cannot be recognized.

Remarks

This method compares the unknown page with all Master Forms pages in the repository and returns the Master Form and the number of the page in that Master Form with maximum confidence.

The recognition of the page will stop comparing the form with other Master Forms either when the confidence of the recognition result is greater or equal to MinimumConfidenceRecognized or when the Master Forms have all been compared.

The result of the recognition will have the result of the Master Form Page with maximum confidence. If the confidence is less than MinimumConfidenceKnownForm it will return null, i.e. the page type is unknown and cannot be recognized.

This method is useful when you have an unknown page and you want to recognize the Master Form to which the page belongs after which you may process the form and extract the data.

Example
C#
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Forms.Common; 
using Leadtools.Forms.Auto; 
using Leadtools.Document; 
using Leadtools.Ocr; 
using Leadtools.Forms.Recognition; 
using Leadtools.Forms.Processing; 
using Leadtools.Barcode; 
 
using Leadtools.Forms; 
 
public void AutoPageRecognitionAndProcessing1File() 
{ 
   string root = Path.Combine(LEAD_VARS.ImagesDir, @"Forms\FormsDemo\OCR_Test"); 
   RasterCodecs codecs = new RasterCodecs(); 
 
   DiskMasterFormsRepository repository = new DiskMasterFormsRepository(codecs, root); 
 
   using (IOcrEngine ocrEngine = OcrEngineManager.CreateEngine(OcrEngineType.LEAD)) 
   { 
      ocrEngine.Startup(null, null, null, LEAD_VARS.OcrLEADRuntimeDir); 
 
      BarcodeEngine barcodeEngine = new BarcodeEngine(); 
 
      AutoFormsEngine autoEngine = new AutoFormsEngine(repository, ocrEngine, barcodeEngine); 
      autoEngine.MinimumConfidenceRecognized = autoEngine.GetMinimumRecognizedConfidencePage(); 
 
      AutoFormsRecognizePageResult result = autoEngine.RecognizePage(Path.Combine(LEAD_VARS.ImagesDir, @"Forms\Forms to be Recognized\OCR\FCC-107_OCR_Filled.tif"), 1, new AutoFormsEnginePageRecognitionOptions()); 
      if (result == null) 
         return; 
      FormPage pageFields = autoEngine.ProcessPage(Path.Combine(LEAD_VARS.ImagesDir, @"Forms\Forms to be Recognized\OCR\FCC-107_OCR_Filled.tif"), 1, result); 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
   public const string OcrLEADRuntimeDir = @"C:\LEADTOOLS23\Bin\Common\OcrLEADRuntime"; 
} 
Requirements

Target Platforms

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Forms.Auto Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.